hotfix(docs): MAJOR.MINOR docs slugs; retire the duplicate 'main' docs version - #414
Merged
Conversation
…s version The version selector showed the same release twice: '0.20.0' (release deploy) and '0.20.0 (stable)' (the main-branch deploy at /main/). Docs versions now use MAJOR.MINOR slugs (/0.20/) with the selector title carrying the full patch version: - deploy_docs_from_main.yaml: deploys main's docs onto the X.Y slug from .env with --title X.Y.Z + latest alias, and sets the site default to 'latest' (was: separate 'main' version + set-default main). A docs hotfix republishes the slug in place and retitles the entry, so URLs never break within a minor line. - deploy_docs_from_release.yaml: same slug scheme (tag 0.21.0 → /0.21/), plus set-default latest. - release_notes_current_version.py hook: match sections by MAJOR.MINOR, so a /0.20/ build shows the 0.20.0 section plus any 0.20.x hotfix sections. - docs_reorder_versions.py: pin only 'develop' to the top (no 'main' entry to pin anymore). - sync-develop-from-main.yaml: read NEW_VERSION from .env for the bump commit message — GITHUB_ENV exports only apply to later steps, so the message said 'Bump VERSION to ' (empty). - Skill + microagent references updated. VERSION 0.20.1 → 0.20.2 (CI/ docs-only change; bump required by the PR gate). One-time gh-pages cleanup after this merges: delete the 'main' and '0.20.0' versions, migrate '0.19.0' → '0.19'. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
andrewjong
added a commit
that referenced
this pull request
Aug 29, 2026
…20/) One-time cleanup for the MAJOR.MINOR slug scheme (#414): stable docs now live at /0.20/ (alias: latest, site default). The 'main' and '0.20.0' copies duplicated it in the version selector.
Contributor
Test Metrics —
|
| Test | Pass | Fail | Skip | Rate |
|---|---|---|---|---|
| test_colcon_build_gcs | 1 | 0 | 0 | 100% |
| test_colcon_build_ms_airsim | 1 | 0 | 0 | 100% |
| test_colcon_build_robot | 1 | 0 | 0 | 100% |
| test_colcon_test_robot | 1 | 0 | 0 | 100% |
Metrics
| Test | Metric | Value |
|---|---|---|
| test_colcon_build_robot | duration_s | 90.28s |
| test_colcon_test_robot | duration_s | 41.12s |
| test_colcon_build_gcs | duration_s | 87.28s |
| test_colcon_build_ms_airsim | duration_s | 15.24s |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes the duplicated version-selector entries ("0.20.0" at
/0.20.0/and "0.20.0 (stable)" at/main/) by moving docs versions to MAJOR.MINOR slugs whose selector title carries the full patch version:deploy_docs_from_main.yaml— deploys main's docs onto theX.Yslug from.env(--title X.Y.Z, aliaslatest,set-default latest) instead of a separatemainversion. A docs hotfix republishes/0.20/in place and retitles the entry (e.g.0.20.0→0.20.2), so URLs never break within a minor line.deploy_docs_from_release.yaml— same scheme (tag0.21.0→/0.21/), plusset-default latest./0.20/build shows the0.20.0section plus any0.20.xhotfix sections (unit-tested locally against synthetic markdown).docs_reorder_versions.py— pins onlydevelopto the top of the selector (develop stays above stable, per Andrew).GITHUB_ENVexports only apply to later steps, so the version is now read from.envin the commit command.VERSION0.20.1→0.20.2(CI/docs-only; bump required by the gate). Skill + OpenHands microagent references updated.After merging (I'll handle it): one-time gh-pages cleanup — delete the
mainand0.20.0versions, migrate0.19.0→0.19. The merge itself triggers the new main deploy (creates/0.20/titled0.20.2) and the auto-sync into develop (expect0.21.0-dev.2with a correctly-worded bump commit message this time).Squash-merge is fine.
🤖 Generated with Claude Code